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(57) ABSTRACT 

A method, a computer system and a computer-readable 
medium are provided for providing ^- single window^ in 
which a usermay both modify a file system hierarchy of the 
^computer system and select a file system object name to use ? 
for saving an application document residing in a memory of 
the computer system as a file system object A window 
containing a visual representation of the file system hierar- 
chy is displayed. A command to modify the file' system 
hierarchy is received in connection- with the window.^The 
received command Jo modify, the file system hierarchy is, 
processed, The visual representation of the file system 
hierarchy is redisplayed in the window to reflect the modi- 
fication of the file system hierarchy. A command to select a 
file system object name within the file system hierarchy is 
received in connection with the window. A representation of 
the application document residing in the memory is stored as 
a file system object using the selected file system object 
name. 
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METHOD AND SYSTEM FOR ACCESSING 
SHELL FOLDER CAPABILITIES BY AN 
APPLICATION PROGRAM 

CROSS-REFERENCE TO RELATED 
APPLICATION 

This application is a file-wrapper continuation of U.S. 
patent application Ser. No. 08/356,081, filed Dec. 13, 1994, 
abandoned. 

TECHNICAL FIELD 

This invention relates generally to a method and system 
for managing folders and, in particular, to a method and 
system in which an application program can access the 
folder management capabilities of a shell program. 

BACKGROUNG OF THE INVENTION 

Computer systems have operating systems that have func- 
tions through which an application program can interact 
with files maintained by the operating system. These func- 
tions include opening, moving, copying, deleting, or renam- 
ing a file. These functions can also include creating and 
naming directories (also known as "folders'*) or subdirecto- 
ries in which to store files. 

Typical computer systems include a shell, which is a 
program that provides direct communications between a 
user and the operating system. For example, a shell may 
provide the capability to list, delete, and copy files, to start 
the execution of other programs, to configure resources, etc. 
The shell may be implemented as a single computer program 
or as several computer programs. For example, a shell may 
include a file manager program that allows a user to manage 
the files stored by a file system portion of the operating 
system. Such a file manager program can move a file from 
one folder to another, copy a file, delete a file, rename a file, 
change various properties associated with the file, and 
launch an application program associated with a file. A file 
manager program can also create new folders. File manager 
programs typically provide comprehensive functionality for 
managing files and folders. 

Application programs often provide capabilities to man- 
age files, but such capabilities are often limited. For 
example, typical word processing programs can only open 
files and save files which are the capabilities needed to 
support word processing. Thus, a user wishing to manipulate 
a file using a function other than opening or saving needs to 
switch from the word processing program to the file man- 
ager program to manipulate the file. For example, when a 
user enters new data using a word processing program; the 
user often wishes to save that new data in a new file stored 
in a new folder. In order to do this, the user enters the new 
data using the word processing program, switches from the 
word processing program to the file manager program to 
create the new folder, and then switches back to the word 
processing program to save the new data in a new file in the 
newly created folder. 

Some application programs include additional file 
manipulation functions that include moving, renaming, and 
deleting files. However, each developer of an application 
program that wants to include additional file manipulation 
functions needs to develop the user interface and computer 
code to support such functions. This development increases 
the burden on the application developer and creates a lack of 
consistency of the user interface for managing files between 
the operating system and the application programs. 
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Additionally, even if an application developer modeled the 
user interface after that provided by the file manager 
program, if the user interface of the file manager program 
was later changed, there would then be a lack of consistency. 

5 The present invention is described below using some 
object-oriented techniques; thus, an overview of well-known 
object-oriented programming techniques is provided. Two 
common characteristics of object-oriented programming 
languages are support for data encapsulation and data type 

10 inheritance. Data encapsulation refers to the binding of 
functions and data. Inheritance refers to the ability to declare 
a data type in terms of other data types. In the C++ language, 
data encapsulation and inheritance are supported through the 
use of classes. A class is a user-defined type. A class 

15 declaration describes the data members and function mem- 
bers of the class. A function member is also referred to as a 
method of a class. The data members and function members 
of a class are bound together in that the function operates on 
an instance of the class. An instance of a class is also called 

20 an object of the class. Thus, a class provides a definition for 
a group of objects with similar properties and common 
behavior. 

To allocate storage for an object of a particular type 
(class), an object is instantiated. Once instantiated, data can 

25 be assigned to the data members of the particular object. 
Also, once instantiated, the function members of the par- 
ticular object can be invoked to access and manipulate the 
data members. Thus, in this manner, the function members 
implement the behavior of the object, and the object pro- 

30 vides a structure for encapsulating data and behavior into a 
single entity. 

To support the concept of inheritance, classes may be 
derived from (based upon the declaration of) other classes. 

35 A derived class is a class that inherits the characteristics — 
data members and function members — of its base classes. A 
class that inherits the characteristics of another class is a 
derived class. A class that does not inherit the characteristics 
of another class is a primary (root) class. A class whose 

^ characteristics are inherited by another class is a base class. 
A derived class may inherit the characteristics of several 
classes; that is, a derived class may have several base 
classes. This is referred to as multiple inheritance. 

A class may also specify whether its function members 

45 are virtual. Declaring that a function member is virtual 
means that the function can be overridden in a polymorphic 
manner by a function of the same name and type in a derived 
class. If a virtual function is declared without providing an 
implementation, then it is referred to as a pure virtual 

50 function. A pure virtual function is a virtual function 
declared with the pure specifier, "=0". If a class specifies a 
pure virtual function, then any derived class needs to specify 
an implementation for that function member before that 
function member may be invoked. A class which contains at 

55 least one pure virtual function member is an abstract class. 
FIG. 1 is a block diagram illustrating typical data struc- 
tures used to represent an object. An object is composed of 
instance data (data members) and function members, which 
implement the behavior of the object. The data structures 

60 used to represent an object comprise instance data structure 
101, virtual function table 102, and the function members 
103, 104, 105. The instance data structure 101 contains a 
pointer to the virtual function table 102 and contains data 
members. The virtual function table 102 contains an entry 

65 for each virtual function member defined for the object. 
Each entry contains a reference to the code that implements 
the corresponding function member. The layout of this 
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sample object conforms to models described in U.S. Pat. No. FIG. 2 is a symbolic representation of an object In the 

5,297,284, entitled "A Method for Implementing Virtual following description, an object data structure is represented 

Functions and Virtual Bases in a Compiler for an Object by the shape 201 labeled with the interfaces through which 

Oriented Programming Language," which is hereby incor- the object may be accessed. As shown, object 201 supports 

porated by reference. In the following, an object will be 5 Untetfacel and IInterface2. 
described as an instance of a class as defined by the C++ 

programming language. One skilled in the art would appre- SUMMARY OF THE INVENTION 

ciate that other object models can be defined using other ^ present mvention provides a system and method mat 

programming languages. . . allows application programs to use the file management 

An advantage of using object-oriented techniques is that 1Q capabilities implemented by shell through a file manager 

these ; techniques can be used to facilitate the ^sharing of Ifl a ferred embodiment , application programs 

objects. For example a program implementing the function £ re * ided ^ ^ appUcation programming intfrface 

members of an instantiated object (a server program 1 can JL.* XT A nrk . \\ ~, 

share the object with another program (a "client program"). (^^ lle u Name ^ t0 ^tneve file names using a common 

lb allow an object of an arbitrary class to be shared with a v im P lemen ^ 0 °; ™« sheU «™ an interface 

client program, interfaces are defined through which an 15 (IShellView) to control a ShellView window in which the 

object can be accessed without the need for the client contents of a current folder are displayed and manipulated, 

program to have access to the class definitions at compile ^ common dialog box implementation uses the IShell- 

time. An interface is a named set of logically related function View interface so that it can provide the same behavior as 

members. In C++, an interface is an abstract class with no the shell provides for managing files and folders. The 

data members and whose virtual functions are all pure. Thus, 20 ShellView window has an associated ShellView window 

an interface provides a published protocol for two programs procedure and an ShellView class. The ShellView window 

to communicate. Interfaces are typically used for derivation; procedure processes messages for the ShellView window, 

a program defines (implements) classes that provide imple- The ShellView class provides an implementation of the 

mentations for the interfaces the classes are derived from. IShellView interface. Since the GetFileName API uses the 

Thereafter, objects are created as instances of these derived 25 implementation of the IShellView interface provided by the 

classes. Objects instantiated from a derived class imple- fij c manager program, the application programs that use the 

anting particular interfaces are said to "support" the inter- GetFileName API provide the same user interface and the 

faces. An object supports one or more interfaces depending same functionality that is provided by the file manager 

upon the desired functionality. program 

When a client program desires to share an object, the ™ A ^ , * . , . 

,. A j . , . . , . 30 A preferred embodiment provides a method in a computer 

client program needs access to the code that implements the * * u t. • i_- * i ^ 

interfa^s for the object (the derived class code). To access svstc " for comprehensive^object manipulation to a 

the derived class code (also referred to as class code), each ^user^aining^, ptobject^name^fiinction. Uicjomputer 

class implementation is given a unique class identifier (a ***** has m ob J ect manager thatcprovides:comprehensive 

"CLSID"). For example, code implementing a spreadsheet ^bject mampulauon to the user. Upon invocation of the get 

object developed by Microsoft Corporation may have a class 35 " °4©ct name function, the method creates a-dialog.window 

identifier of "MSSpreadsheet," while code implementing a fw receiving the name of an object.The method then creates 

spreadsheet object developed by another corporation may r aview window provided by the object manager and provides 

have a class identifier of "LTSSpreadsheet." A persistent a folder of objects to the view wmdow-for display and 

registry in each computer system is maintained that maps manipulation. Under control of the view window, the 

each CLSID to the code that implements the class. Typically, 40 ^method then receives user- requests-to-manipulate-the dis- 

when a spreadsheet program is installed on a computer played objects. 1 The method men manipulates the displayed 

system, the persistent registry is updated to reflect the object, and notifies the dialog window of changes in state of 

availability of that class of spreadsheet objects. So long as the displayed objects. Under control of the dialog window, 

a spreadsheet developer implements each function member me method updates the dialog wmdow to reflect the change 

defined by the interfaces to be supported by spreadsheet 45 m the~state wherein-theview wmdow-provides a-comprer 

objects and so long as the persistent registry is maintained, tensive object manipulation^ 

the client program can access the function members of object-name function, 

shared spreadsheet objects without regard to which server i_ . - - - , * 

program has implemented them or how they have been BRIEF DESCRIPTION OF THE DRAWINGS 

implemented 50 mG lis& block diagram illustrating typical data struc- 

Since an object may support some interfaces and not tures used to represent an object, 

others, a client program would need to determine at runtime nG . 2 is a symbolic representation of an object, 

whether a particular object supports a particular interface. To ,. ' - . , . . . t 

li .* * t . /- ,. r . ^ . . FIG. 3 is a diagram of the Dialog window associated with 

enable this determination, every object supports the inter- ^ & 

face I Unknown, which contains a function member, 



the GetFileName API. 



Querylnterface, that indicates which interfaces are imple- ^G. 4 is a block diagram illustrating a sample configu- 

mented for the object. The method Querylnterface is defined ration of a compute* svstem for practicing the present 

as follows: invention, 

virtual HRESULT Querylnterface (REFIID iid, ^G. 5 is a block diagram illustrating data structure and 

void* *ppv)-0; 60 P r °g ram layout of the application program in the memory of 

The method Querylnterface is passed an interface identifier me computer system. 

in parameter iid (of type REFIID) and returns in parameter FIG. 6 is a flow diagram of the method IShellView: :Re- 

ppv a pointer to the implementation of the identified inter- fresh. 

face of the object for which the method is invoked. If the FIG. 7 is a flow diagram of the method IShellView: :Cre- 

object does not support the interface, then the method 65 ateWindow. 

returns a false. The type HRESULT indicates a predefined FIG. 8 is a flow diagram of the method IShellView::S- 

status. electltem. 
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FIG. 9 is a flow diagram of the method ICommDlg- of the ICommDlgBrowser interface. The invocation of this 

Browser: : Include Object . method notifies the GetFileName API that a default behavior 

FIGS. 10 through 12 are flow diagrams of portions of the has *x* n requested by the user. In this example, the Get- 
Dialog window procedure. FileName API would direct the creation of another SheU- 

5 View object to control the displaying of the contents of the 

DETAILED DESCRIPTION OF THE selected folder 

INVENTION The Dialog window controls the inputting of the file name 

The present invention provides a system and method that °[ *? file «° A ^" wi ? dow i"P« the name 
allows application programs to use the file management of . a whcn T™* a . file - nG - 3 * a dla g ram of * e Dlalo g 
capabilities implemented by shell through a file manager 10 associated with the GetFileName API. The apph- 
program. In a preferred embodiment, application programs catlon P r °g ram typaSfy invoke the GetFileName 
are provided with an application programming interface ^ to ^P 1 ^. 8 box whlch °» user mav 
(GetFileName API) to retrieve file names using a common select a ^ or m P ut tbe name of a flle - ^ e Dlalo 8 window 
dialog box implementation. The shell uses an interface 301 oontains a Buttons window 302 and a ShellView win- 
(IShellView) to control a ShellView window in which the 15 dow 303 ^ Dialog window also contains a Lookto hstbox 
contents of a current folder are displayed and manipulated. 3ft5 > a FileName field 306, a FileType field 307, and a 
The common dialog box implementation uses the IShell- Readonly field 308. The Lookln hstbox 305 displays a 
View interface so that it can provide the same behavior as locall0n of folders. The FileName field 306inputs a file 
the shell provides for managing files and folders. The name or specification of a list of file names. The FileType 
ShellView window has an associated ShellView window 20 307 inputs file type information. The Readonly field 
procedure and an ShellView class. The ShellView window 3" «>puts whether the file is to be opened in read only 
procedure processes messages for the ShellView window. mode> : ™ e Butto 1 ns T ? f? ntaMS buM ? n f to ^ a 
The ShellView class provides an implementation of the l^&^tom^fhsv^b^toc^^o^Slc, 
ISheUView interface. Since the GetFUeName API uses the „ J* to mdicate 71,6 SheUView window 303 displays 
implementation of the IShellView interface provided by the 25 information on the items of the current folder. The Shell- 
file manager program, the application programs that use the ^ is implemented by the shell. The various 
GetFileName API provide the same user interface and the windows each have window procedures for receiving and 
same functionality that is provided by the file manager processing messages. 

program. ' n operation, the application program invokes the Get- 

To provide the same behavior as the shell for managing *° ^NameAPIto * e name of * ®*\ foT ^T^' * 

folders and files, an application program invokes the Get- -J** GetFUeName API creates UK > Dialog window and 

FileName API which provides a Dialog window (or other ^ tl 1 ahzes * e Dialo S ^fow P^ure to process the 

type of window) that contains a SheUView window. The Dialog wmdow messages Tlie Lookln hstbox 305 provides 

GetFileName API first instantiates a ShellFolder object 35 f. ^rarchical listing of foWer names, known as a locahon 

correspondiiig to the folder to be displayed in the ShellView ^ The location list preferably contains the predefined 

window. ITie ShellFolder object provides an implementation ? T e ™ "Desktop, "My Computer and "Network 

of the IShellFolder interface. The IShellFolder interface Neighborhood, and all the drives in My Computer. In 

provides methods for accessing information relating to the f***™. location list contains aU subfolders down to and 

folder, for enumerating the contents of the folder and for ^ ?^ udin S folder u * or exan ? le > * the cum f 

retrieving a display name for each item (e.g., file or folder) *> ? er were C:\Doc\Patents, the locaUon list may contain the 

within the folder. The IShellFolder interface also provides a foUowing. 

method that creates a ShellView object associated with the Desktop 

folder. M y Computer 

The GetFileName API then creates a ShellView object 4s ^ 

that provides the IShellView interface. The IShellView C: 

interface provides methods for creating and displaying the DOCS 

SheUView window and manipulating the contents of the Patents 

SheUView window. After the GetFileName API creates the X: 

Dialog window, the GetFileName API directs the SheUView 50 Network: Neighborhood. 

object to create the SheUView window. jh e "Network Neighborhood" is a folder that identifies the 

The GetFUeName API provides an implementation of a computers connected through a network, 

class FileBrowser that includes an implementation of an A user can select a folder listed in the Lookln Hstbox to 

IShellBrowser interface and an ICommDlgBrowser inter- have its contents displayed in the SheUView window. A user 

face. The IShellBrowser interface provides methods through 55 can also browse the location list to select the folder in which 

which a ShellView object can communicate with the Dialog to have its subfolders displayed in tbe location list. A user 

window. For example, if the Dialog window were to include can also select a folder listed in the SheUView window to 

menus or a tool bar, then methods of the IShellBrowser have the selected folder become the current folder in the 

interface could be used by the SheUView object to add to the location list. A user can either enter the name of the file to 

menu or the tool bar of the Dialog window any additional 60 open in the FileName field or select a file name listed in the 

menu or toolbar items that the SheUView window supports. SheUView window and then select the OK button to desig- 

The ICommDlgBrowser interface provides methods through nate the file to open. 

which the SheUView object can aUow the GetFUeName API Since the SheUView window is the same window as 

to override the default behavior of the SheUView object. For implemented by the file manager program of the shell, the 

example, if a user double clicks (i.e., indicating a default 65 SheUView window supports the same functionality and user 

action to be performed), on the name of a folder listed in the interface as tile file manager program supports. For example, 

SheUView window, the SheUView object invokes a method when a user right clicks on an item in the SheUView window, 
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the ShellView object directs the displaying of a pop-up 
menu of file management capabilities associated with that 
item. The file management capabilities may include 
deleting, renaming, or moving a file. 

FIG. 4 is a block diagram illustrating a sample configu- 
ration of a computer system for practicing the present 
invention. The computer system 401 includes a central 
processing unit (CPU) 402, a memory 403, secondary stor- 
age 404, output devices 405, and input devices 406. The 
CPU controls the execution of the programs stored in 
memory. The programs stored in memory include the oper- 
ating system and application programs of a preferred 
embodiment. The CPU interacts with secondary storage 
(e.g., disk drives) to store and retrieve data. The CPU inputs 
data from a user through input devices (e.g., mouse and 
keyboard) and output data to a user through output devices 
(e.g., a display or printer). 

FIG. 5 is a block diagram illustrating the data structure 
and program layout of the GetFileName API in the memory 
of the computer system. The GetFileName API includes a 
FileOpenBrowser object 501, a ShellFolder object 502, a 
ShellView object 503, and a ContextMenu object 504. The 
GetFileName API also includes a Dialog window procedure, 
505, a ShellView window procedure 506, and a Buttons 
window procedure. As described in the following, the 
objects and window procedures interact to implement a 
preferred embodiment of the present invention. A descrip- 
tion of each of the interfaces is provided followed by a 
description of the window procedures. 
IShellFolder 
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interface IShellFolder: IUnknown 

BindToObject(ObjectIdentifier, riid, ppvOut) 
Create ViewObject(hwndOwner, riid, ppvOut) 
GetAttributesOf(ObjectIdentifier, attributes) 
GetUIObjectOf(ObjectIdentifiers, riid, ppvOut) 
GetDisplayNameOrl(ObjectIdentifier, Name) 
SetNameOf(ObjectIdentifier, Name, 

NewObj ectldentifier) 
EnumObjects(ppenumIDList) 40 

} 

The IShellFolder interface provides methods for access- 
ing the items within a folder. A folder is a collection of items, 
such as folders and files or other objects that have an 
implementation of the IShellFolder interface. Thus, a col- 45 
lection of folders form a hierarchy. Each item in a folder has 
an identifier. Each folder includes the identifier of the items 
it contains and the attributes of each item. The attributes 
include a display name of the item, an indication whether the 
item is read-only, etc. An item can be uniquely identified by 50 
the sequence of identifiers ("an Objectldentifier") from the 
root folder, that is, the Desktop. The Objectldentifier is a list 
of the folder identifiers from the root to the item. An 
Objectldentifier can be absolute (from the root folder) or 
relative (to the current folder). 55 

The method IShellFolder :BindTo Object instantiates a 
ShellFolder object for an item contained within this folder 
and returns a pointer to an interface of the new ShellFolder 
object. (In the following, the use of the term "this" refers to 
the instance in which the method is being invoked.) The 60 
passed parameter Objectldentifier identifies the item relative 
to this folder. The passed parameter riid identifies the 
interface to return (e.g., IID-IShellFolder). The returned 
parameter ppvOut is a pointer to the interface identified in 
parameter riid of the newly instantiated ShellFolder object. 65 
The new ShellFolder object contains data describing the 
contents of the folder. 



The method IShellFolder: :CreateViewObject instantiates 
a ShellView object for this folder. The passed parameter 
hwndOwner identifies the window that owns the ShellView 
object. In the implementation of the GetFileName API, the 
Dialog window owns the ShellView window. The passed 
parameter riid identifies the IShelTVlew interface. The 
returned parameter ppvOut points to the IShelTVlew inter- 
face of the instantiated ShellView object. 

The method IShellFolder: :GetAttributesOf returns the 
attributes of an item of this folder. The passed parameter 
Objectldentifier identifies the item relative to this folder. The 
return parameter attributes contains the attributes. The 
attributes include whether the item can be copied, moved, 
and deleted, and whether the item is read-only, a folder, or 
a file, etc. 

The method IShellFolder: :GetUIObjectOf creates a Con- 
textMenu object for an item or group of items. The param- 
eter Objectldentifiers identifies the item relative to this 
folder. The parameter riid indicates the interface to return, 
and the parameter ppvOut is a pointer to the returned 
interface of the ContextMenu object This method can return 
pointers to an IContextMenu interface, an IExtractlcon 
interface, or other interfaces for accessing behavior of an 
item. The IContextMenu interface as described below in 
detail provides methods for accessing a menu for manipu- 
lating the item. The IExtractlcon interface provides methods 
for retrieving an icon associated with the item. 

The method IShellFolder:: GetDisplayNameOf returns the 
display name of an item. The passed parameter Objectlden- 
tifier identifies the item relative to this folder. The returned 
parameter Name contains the display name of the item 
identified by parameter Objectldentifier. 

The method IShellFolder: :SetNameOf sets the name of an 
item. The passed parameter Objectldentifier identifies the 
item relative to this folder. The passed parameter Name 
contains the new name. The returned parameter NewObj ec- 
tldentifier contains the new Objectldentifier, which may 
have changed because of the change in name. 

The method IShellFolder:: EnumObjects returns a pointer 
to an enumerator interface for enumerating the contents of 
this folder. The returned parameter ppenumlDList is a 
pointer to the enumerator interface. The methods of the 
enumerator interface allow for enumeration of the items in 
this folder. The method of the enumerator interface allows 
for the retrieval of the Objectldentifiers of the items in this 
folder. 
IShellView 

interface IShellView: IUnknown 
{ 

GetWindow(hwndShellWindow) 

UIActivate(state) 

Refresh( ) 

Create ViewWindow(settings, pISbellBrowser, pre View, 

hwndSbellWindow) 
Destroy ViewWiodow( ) 
GetCurrentInfo(settings) 
Selectltem(0bjectldentifiers, flag) 
GetItemObject(ObjectIdentifier, riid, ppv) 

} 

The IShellView interface provides methods for creating, 
displaying, manipulating, and destroying a ShellView win- 
dow. When a ShellView object is created by a ShellFolder 
object, the ShellView object is initialized to contain a pointer 
to the IShellFolder interface. Using the methods of that 
IShellFolder interface, the ShellView object can retrieve the 
contents of the folder for which it was created. 
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The method IShellView::GetWindow returns the handle FIG. 8 is a flow diagram of the method IShellView::S- 

for the ShellView window. electltem. The method Selectltem sets the items to selected 

The method IShellView::UIActivate is invoked whenever or deselected in the ShellView window. The passed param- 
the activation of the ShellView window changes as a result e ter Objectldentifiers identify a list of items of the Shell- 
of an event external to the ShellView window. The passed 5 View window to select or deselect. The passed parameter 
parameter state mdicates whether the ShellView window is flags indicates whether the items are to be selected or 
to be deactivated, loses the focus, or is given the focus. For deselected . In step m> jf me passed flag Skates ^ the 

SS&V C "? F**™ fi r W '. items ■» the method continues at step 802, 
method is invoked to indicate a change in activation. This ^ w t . maiU *A ™*™««. „ fM en* T „ — «v> >ul 

method sends a message to the ShellView window to effect in els * * e contmues at step 803^ step 802 the 

the change in the activation status. 10 m cthod ™ ii uL the , Sh ^ UView window. 

FIG. 6 is a flow diagram of the method ISheU\iew::Re- L 803 > method sends a "deselect message to the 
fresh. Hie method Refresh refreshes the content of the SheUView window. In step 804, if the ICommDlgBrowser 
SheUView window. The content is refreshed by retrieving interface is not implemented by the program, then the 
the items from the folder associated with this SheUView method returns, else the method continues at step 805. In 
object and displaying the display names of the retrieved 15 slc P ^» mc method notifies the GetFfleName API of a 
items. The SheUView window may need to be refreshed change in state of the selection within the SheUView win- 
after items are deleted from the associated folder. In step dow and returns. The method notifies the GetFUeName API 
601, the method retrieves an enumerator for the SheilFolder by invoking' the method ICommDlgBrowser:: OnStat- 
object associated with this SheUView object. In steps 602 eChange. 

through 606, the method loops retrieving the items in the 20 The method ISheUView::GetItemObject returns a pointer 

SheilFolder object and adding the items to a list to be to designated interface of an item. This method instantiates 

displayed. In step 602, the method selects the next item in a ContextMenu object for the item. The passed parameter 

the SheilFolder object. If aU the items in the SheilFolder Objectldentifier identifies the item. The passed parameter 

object have already been selected, then the method contin- riid identifies the interface of the ContextMenu object to be 

ues at step 607, else the method continues at step 603. In step 25 returned. The returned parameter ppv is a pointer to the 

603, the method determines whether the ShellView object interface of the ContextMenu object. The interface may be 

has been instantiated as part of a common dialog box the IContextMenu interface or the IDataObject interface, 

implementation. If the ICommDlgBrowser interface has The IDataObject interface is described in "Inside OLE 2" 

been implemented, then it is part of a common dialog box published by Microsoft Press, which is hereby incorporated 

implementation and the method continues at step 604, else 30 by reference, 

the method continues at step 605. In step 604, the method IShellBrowser 
determines whether the selected item should be displayed by 

invoking the method ICommDlgBrowser: :IncludeObjecL If interface IShellBrowser: I Unknown 

the selected item should be displayed, then the method { 

continues at step 605, else the method loops to step 602 to 35 GetWindow(hwndDialogWindow) 

select the next item. In step 605, the method retrieves the InsertMenusSB(hmemiShared, lpMenuWidths) 

A 7 e r° f ^ f ^ 1 nf y ! 6 ffl f SetMenuSB(hmenuShared, holemenu, 

ISheUFolder:GetDisplayNameOf. In step 606, the method h , A t - J? w rt 

adds the display name to the list and loops to step 602 to D nw ^uveubject; 

select the next item. In step 607, the method repaints the 40 RemoveMenusSB(hmenuShared) 

SheUView window and returns. SetStatusTextSB(StatusText) BrowseObject 

FIG. 7 is a flow diagram of the method ISheUView::Cre- (Objectldentifier, flags) 

ate Window. The method Create ViewWindow creates and GetControlWindow(hwndToolbar) 

displays a SheUView window. The passed parameter settings SendControlMsg(uMsg, wParam, IParam, pret) 

are the folder settings (e.g., whether to display icons asso- 45 QueryActiveSheUView(ppshv) 

ciated with item) to control the display of the items in the SetTooIBarItems(lpButtons, nButtons, flags) 

folder. The passed pointer pIShcllBrowser points the SheU- } 

Browser object. The passed parameter pre View indicate the The IShellBrowser interface provides methods for con- 
rectangle at which to position the SheUView window. The trolling the Dialog window. The GetFileName API provides 
returned parameter hwndSheUWindow points to the handle 50 an implementation for each of these methods. The ISheU- 
of the newly created SheUView window. In step 701, the Browser interface allows the SheUView object to interact 
method creates a SheUView window. In step 702, the method with its container object, logicaUy, the SheUBrowser object, 
determines whether the SheUView window is being created The method IShellBrowser::GetWindow returns the 
for an appUcation program. The GetFfleName API imple- handle of the Dialog window associated with this SheU- 
ments the interface ICommDlgBrowser. The method 55 Browser object. The returned parameter pbwndDialogWin- 
invokes the method IShellBrowser: :Query Interface to deter- dow is a pointer to the Dialog window. The methods 
mine if the interface ICommDlgBrowser is implemented. In InsertMenusSB, SetMenuSB, and RemoveMenuSB of the 
step 703, the method invokes the method ISheUView::Re- IShellBrowser interface allows for the menus of the con- 
fresh to display the contents of the SheilFolder and the tainer window to modified by the SheUView object. Since a 
method then returns. 60 dialog box has no menus, these methods can be implemented 
The method IShellView:: Destroy ViewWindow destroys to have no functional effect when the SheUView object asks 
the SheUView window associated with this SheUView to integrate menus. The integration of menu is described in 
object. The method ISheUView::GetCurrentInfo returns the patent appUcation Ser. No. 07/984,868, entitled "Method 
current folder setting for this SheUView object. The returned and System for In-Place Interaction with Embedded 
parameter settings contain the folder settings. The folder 65 Objects/* filed on Dec. 1, 1992 which is hereby incorporated 
settings include information that controls the display of the by reference. The method IShellBrowser SetStatusTextSB 
folder contents (e.g. the size of the icons). sets the text of the status line of the Dialog window. 
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The method IShellBrowser::BrowseObject controls the object. In step 903, if the display name is compatible with 

browsing through another folder. The passed parameter the FileName field, then the method returns an OK, else the 

Objectldentifier identifies the path to the folder that is to be method returns a Not_OK. A display name is compatible 

browsed. The passed parameter flags indicates whether the with the FileName field when, for example, display name 

path is absolute or relative or whether the parent folder is to 5 matches the wild card specification in the FileName field, 

be browsed. IContextMenu 

Hie method IShellBrowser::GetControlWindow returns 

the handle to the toolbar window. The returned parameter interface IContextMenu: IUnknown 

hwndToolbar is the handle. { 

The method IShellBrowser::SendControlMsg sends the 10 QueryContextMenu(hmenu); 

designated messages to the toolbar or window. The passed lovokeCommand (command); 

parameters uMsg, wParam, and lParam identify the mes- j 

sage. The returned parameter pret indicates the result. ^ ICo ntextMenu interface provides methods for 

The method IShellBrowser::QueryActiveShellView retrieving a menu associated with an item and for invoking 

returns a pointer to the active ShellView object associated 1S ^ a mcmi itcm & selected. A ContextMenu 

with the ShellBrowser object. The returned parameter ppshv ^ coated for an item or list of items, 

is a pointer to the ShellView object. me thod IContextMenu: :QueryContextMenu initial- 

The method- ISheUBrowser::SetToolBarItems is invoked tbe m ^ nu for ^ item for Wmch it was insianuated: The 

to set the toolbar for the Dialog window. The passed parameter hmenu is a handle to the menu into which the 

parameters lpButtons and nButtons specify the array of 20 me nu items for the item are to be stored. The menu items can 

buttons to add. The passed parameter flags specify whether be either sta ndard for the item or extended menu items that 

the buttons are to be merged or added to the end of the ^ ^ nQd for the type of ^ menu item ^ extended 

toolbar. menu are defined in a global registry. 

ICommDlgBrowser The method IContextMenu:: I nvokeCommand is used to 

25 perform the behavior of a menu item. The parameter corn- 
interface ICommDlgBrowser: IUnknown man j idcntifies mc command. The method performs the 

OnDefault(ppshv) behavior for the standard menu items or invokes code 

OnStateChange(uChange) specific to the extended menu items. 

IncludeObject( Objectldentifier) Dialog Window Procedure 

} 30 FIGS. 10 through 12 are flow diagrams of portions of the 

The ICommDlgBrowser interface provides a call back Dialog window procedure. FIG. 10 illustrates the processing 

mechanism through which a ShellView object can notify its of an initialization message. In response to an initialization 

container ShellBrowser object of certain events it may want message, the procedure instantiates an FileOpenBrowser 

to handle. The method ICommDlgBrowser: :OnDefault is object and an ShellFolder object. The procedure then dis- 

called by the ShellView object when the user double clicks 35 plays the current folder in the ShellView window. In step 

in the ShellView window, selects the default menu item off 1001, if the message is an initialization message, then the 

an items context menu, or presses enter. The passed param- procedure continues at step 1002, else the procedure con- 

eter ppshv is a pointer to the ShellView object. The method tinues to check for another message. In step 1002, the 

returns OK as its value if it processed the command. This procedure instantiates a FileOpenBrowser object and stores 

method allows the ShellBrowser object the opportunity to, 40 a pointer (pIShellBrowser) to the object. In step 1003, the 

for example, change the current folder to the folder selected procedure creates and displays a Buttons window for the 

by the double click. Tbe method retrieves the currently Dialog window. In step 1004, the procedure instantiates a 

selected items by invoking the method IShellView::GetIte- ShellFolder object for the Desktop and retrieves a pointer to 

mObject requesting a pointer to the IDataObject interface. its IShellFolder interface. The desktop is logically the root of 

The method then invokes the methods of the IDataObject 45 the folder heirarchy. In step 1005, the procedure enumerates 

interface to retrieve data that identifies the items selected. the folders in the ShellFolder object The procedure enu- 

The method ICommDlgBrowser: :OnState Change is merates the items by invoking the method IShell- 

called when the state of the ShellView Window changes. Folder::EnumObjects to get an enumerator for the items in 

The states include when the focus changes, when the selec- the folder. In step 1008, the procedure adds the enumerated 

tion changes, or when an item is renamed. The passed 50 folders to the location list. In step 1008, the procedure 

parameter uChange indicates the state that changed. This retrieves the name of the current folder and instantiates a 

method allows the ShellBrowser object the opportunity to ShellFolder object for the current folder and stores its 

update tbe fields of the Dialog window. For example, if the pointer. In step 1009, the procedure invokes the function 

selection changes, the FileName field is updated to include LocationChange to initialize the ShellView window with 

the list of the selected items. As discussed above, the list of 55 information for the current folder. The function Location- 

the selected items can be retrieved using tbe IDataObject Change is described below in detail, 

interface. FIG; llris a flow diagram that illustrates the processing of 

FIG. 9 is a flow diagram of the method ICommDlg- a .command message by the Dialog- window procedure. A - 
Browser:: IncludeObject. Hie method IncludeObject indi- command message indicates that a toolbar command or an 
cates whether an item should be included in the ShellView 60 enter command has been selected. In step 1101, if the 
window. Tbe passed parameter Objectldentifier is the path message is a command message, then the procedure contin- 
narne to an item relative to the current folder. The method ties at.step 1102, else the procedure continues to check for 
returns OK as its value if the item is to be included. In step another message. In step 1102, if tbe command is a toolbar 
901, the method retrieves the FileName field of the Dialog command, then the procedure continues at step 1103, else 
window. In step 902, the method retrieves the display name 65 the procedure continues at step 1105. In step U03, the 
of the passed item by invoking the method IS he 11- procedure instantiates and retrieves a pointer to a Context- 
Folder: :GetDisplayNameOf for the current ShellFolder Menu object for the current folder. In step 1104, the proce- 
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dure dispatches the toolbar command to be processed and 
returns. In step 1105, if the command is the OK button or the 
enter key, then the procedure continues at step 1108, else the 
procedure continues at step 1106. In step 1106, if the 
command is the cancel command, then the procedure con- 
tinues at step 1107, else the procedure returns. In step 1107, 
the procedure sets a flag indicating that cancel was selected. 
A message loop for the dialog box detects this flag and 
returns to the GetFileName API. In step 1108 ,-the procedure 
parses the user input in the FileName fiel& In step 1109, if 
a file name was entered in the FileName field, then the 
procedure continues at step 1110, else the procedure con- 
tinues at step 1111. In step 1110, the procedure sets a flag 
indicating that the OK button was selected and sets infor- 
mation indicating the selected items. Control is then trans- 
ferred to the GetFileName API as described above. In step 

1111, if the user entered a folder name, then the procedure 
continues at ' step '1112,* else trie procedure returns* " In step 

1112, the procedure invokes the function LocationChange to 
effect the change of the folder and returns. 

FIG. 12 is a flow diagram of the function Location- 
Change. In step 1201, if there is no current ShellView object, 
then the function continues at step 1203, else the function 
continues at step 1202. In step 1202, the function retrieves 
the folder settings of the current ShellView object by invok- 
ing the method IShellView::GetCurrentInfo. In step 1203, 
the function creates a ShelTViewObject for the current folder 
by invoking the method IShellFolden: Create Vie wObject. In 
steps 1204, 1205, and 1206, if there is already a ShellView 
object, the function destroys it and sets the new ShellView 
object to be the current ShellView object In step 1207, the 
function creates a ShellView window for the current Shell- 
View object. In step 1208, the function displays the Shell- 
View window. In step 1209, the function retrieves a Con- 
textObject for the current folder by invoking the method 
IShellFolder::GetUIObjectOf. In step 1210, the function 
enables the buttons appropriate for the menu indicated by 
the method IContextObject::QueryContextMenu and 
returns. 

ShellView Window Procedure 

The ShellView window procedure controls the standard 
processing of the ShellView window. In particular, the 
ShellView window procedure controls the standard manipu- 
lation of items that is provided the file manager. However, 
the ShellView window procedure needs to notify the Shell- 
Browser object of changes in the state of the ShellView 
window and needs to request services of the ShellBrowser. 
The ShellView window procedure invokes the methods of 
ICommDlgBrowser interface to communicate with the 
ShellBrowser object. 

The ShelTView window procedure notifies the Shell- 
Browser object when the selection of the items in the 
ShellView window changes, when an item in the ShellView 
window is renamed, when the default action for an item in 
the ShellView window is indicated, and when the state of the 
focus of the ShellView window changes. The ShellView 
window procedure invokes the services of the ShellBrowser 
object to determine which of the items in the folder to 
display in the ShellView window. 

When the ShellView window procedure detects a change 
in selection of its items, the ShellView window procedure 
invokes the method ICommDlgBrowser :OnStateChange. 
As discussed above the method OnStateChange determines 
which items are selected by invoking the method of the 
IDataObject interface. The method OnStateChange updates 
the fields of the Dialog window to reflect the change in the 
selection. 
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When the ShellView window procedure detects that an 
item is renamed, the ShellView window procedure invokes 
the method ICommDlgBrowser:: OnStateChange. The 
method OnStateChange determines which item is selected 
5 and updates the fields of the Dialog window accordingly. For , 
example, if the selected item is currently displayed in the 
FileName field, the its name in the FileName field is 
changed to reflect the new name. 

When the ShellView window procedure detects that a user 
has indicated that the default action for a selected item . 
should be performed, the ShellView window procedure 
invokes the method ICbmmDlgBrowser::OnDefault. As dis- 
cussed above, the method OnDefault effectively overrides 
the behavior provided by the ShellView object. 

When the ShellView window procedure receives a change 
15 in focus message, the ShellView window procedure invokes 
the method ICommDlgBrowser:: OnStateChange. The 
method OnStateChange sets the fields and controls of the 
Dialog window to reflect the change in focus. ~ 
When the ShellView window procedure needs to refresh 
20 its window, the ShellView window procedure invokes the 
method ICommDlgBrowser:: I nchideObject. The method 
IncludeObject, as discussed above, determines whether the 
passed item should be included in the refreshed ShellView 
window. 

25 Although the present invention has been described in 
terms of a preferred embodiment, it is not intended that the 
invention be limited to this embodiment. Modifications 
within the spirit of the invention will be apparent to those 
skilled in the art. The scope of the present invention is 

3Q defined by the claims that follow. 
What is claimed is: 

1. A method in a computer system for providing a single 
window in which a user may both modify a filesystem 
hierarchy of the computer system and select a filesystem 
object name to use for saving an application document 
residing in a memory of the computer system as a filesystem 
object, the method comprising the steps of: 

(a) displaying a window containing a visual representa- 
tion of the filesystem hierarchy; 

(b) receiving in connection with the window a command 
to modify the filesystem hierarchy; 

(c) processing the received command to modify the 
filesystem hierarchy; 

(d) redisplaying the visual representation of the filesystem 
45 hierarchy in the window to reflect the modification of 

the filesystem hierarchy; 

(e) receiving in connection with the window a command 
to select a filesystem object name within the filesystem 
hierarchy; and 

50 (f) storing as a filesystem object a representation of the 
application document residing in the memory, using the 
selected filesystem object name. 

2. The method of claim 1 wherein step (b) includes the 
step of receiving a command to delete an identified filesys- 

55 tern object of the filesystem hierarchy, and wherein step (c) 
includes the step of deleting the identified filesystem object. 

3. The method of claim 1 wherein step (b) includes the 
step of receiving a command to rename to a target name an 
identified filesystem object of the filesystem hierarchy, and 

60 wherein step (c) includes the step of renaming the identified 
filesystem object to the target name. 

4. The method of claim 1 wherein step (b) includes the 
step of receiving a command to move to a target location in 
the filesystem hierarchy an identified filesystem object of the 

65 filesystem hierarchy, and wherein step (c) includes the step 
of moving the identified filesystem object to the target 
location. 
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5. The method of claim 1 wherein step (b) includes the commands that are applicable to the identified filesystem 
step of receiving a command to create a container object in object, and wherein step (c) includes the step of displaying 
the filesystem hierarchy at a target location, and wherein a menu showing a list of substantive commands that are 
step (c) includes the step of creating a container object in the applicable to the identified filesystem object, 
filesystem hierarchy at the target location. 5 * 5 * A method in a computer system having an operating 

6. The method of claim 5 wherein step (e) includes the system and a filesystem hierarchy, the filesystem hierarchy 
step of receiving a command selecting a filesystem object organizing filesystem objects having names that identify the 
name within the created container object, and wherein step filesystem objects within the filesystem hierarchy, the 
(f) includes the step of saving the application document method for performing filesystem hierarchy manipulation 
within the created container object. 10 and filesystem object name selection services in an appli- 

7. The method of claim 1 wherein step (b) includes the cation programming interface implemented by the operating 
step of receiving a command to display, for an identified system, the method comprising the steps o£ 
filesystem object, a menu showing a list of substantive (a) receiving an application programming interface call 
commands that are applicable to the identified filesystem from an application program; and 

object, and wherein step (c) includes the step of displaying 15 (b) in response to the received application programming 

a menu showing a list of substantive commands that are interface call, under the control of the operating sys- 

applicable to the identified filesystem object. tern: 

8. A computer-readable medium whose contents cause a (1) receiving directly from a user a command to modify 
computer system to provide a single window in which the the filesystem hierarchy, 

user may both modify a filesystem hierarchy of the computer 20 (2) processing the received command to modify the 

system and select a filesystem object name to use for saving filesystem hierarchy, 

an application document residing in a memory of the com- (3) receiving directly from a user a command to select 

puter system as a filesystem object by performing the steps a filesystem object name occurring within the file- 

of: system hierarchy, and 

(a) displaying a window containing an indication of a 25 ( 4 ) returning the selected filesystem object name to the 
command to modify the filesystem hierarchy and an application program. 

indication of a command to select a filesystem object 16. The method of claim 15, further including the step of 

name; saving a document using the returned filesystem object name 

(b) receiving from the user a selection of the command to ttn ^ r *» ^"f 01 J o£ f m f ™*?* M , u 
modify the filesystem hierarchy; 30 The methcwl of claim 15, further including the step of 

.... , . . opening a document using the returned filesystem object 

(c) modifying jhe filesystem hierarchy in accordance with name under me of tbe application program . 

the received selection of the command to modify the 18 ^ method of claim 15> mrther mcluding the steo of 

esys m erarc y; printing a document using the returned filesystem object 

(d) receiving from the user a selection of the command to 35 name under the control of the application program, 
select a filesystem object name; and 19, The method of claim 15 wherein step (1) includes the 

(e) storing as a filesystem object a representation of the step of receiving a command to delete an identified filesys- 
application document residing in memory, using the tern object of the filesystem hierarchy, and wherein step (2) 
selected filesystem object name. includes the step of deleting the identified filesystem object. 

9. The method of claim 8 wherein step (b) includes the 40 20. The method of claim 15 wherein step (1) includes the 
step of receiving a command to delete an identified filesys- step of receiving a command to rename to a target name an 
tern object of the filesystem hierarchy, and wherein step (c) identified filesystem object of the filesystem hierarchy, and 
includes the step of deleting the identified filesystem object. wherein step (2) includes the step of renaming the identified 

10. The method of claim 8 wherein step (b) includes the filesystem object to the target name. 

step of receiving a command to rename to a target name an 45 21. The method of claim 15 wherein step (1) includes the 

identified filesystem object of the filesystem hierarchy, and step of receiving a command to move to a target location in 

wherein step (c) includes the step of renaming the identified the filesystem hierarchy an identified filesystem object of the 

filesystem object to the target name. filesystem hierarchy, and wherein step (2) includes the step 

11. The method of claim 8 wherein step (b) includes the of moving the identified filesystem object to the target 
step of receiving a command to move to a target location in 50 location. 

the filesystem hierarchy an identified filesystem object of the 22. The method of claim 15 wherein step (1) includes the 

filesystem hierarchy, and wherein step (c) includes the step step of receiving a command to search for a filesystem object 

of moving the identified filesystem object to the target of the filesystem hierarchy having specified attributes, and 

location. wherein step (2) includes the step of displaying an indication 

12. The method of claim 8 wherein step (b) includes the 55 of an object of the filesystem hierarchy having the specified 
step of receiving a command to create a container object in attributes. 

the filesystem hierarchy at a target location, and wherein 23. The method of claim 15 wherein step (1) includes the 

step (c) includes the step of creating a container object in the step of receiving a command to create a container object in 

filesystem hierarchy at the target location. the filesystem hierarchy at a target location, and wherein 

13. The method of claim 12 wherein step (d) includes the 60 step (2) includes the step of creating a container object in the 
step of receiving a command selecting a filesystem object filesystem hierarchy at the target location. 

name within the created container object, and wherein step 24. The method of claim 23 wherein the selecting step 

(e) includes the step of saving the application document includes the step of selecting a filesystem object name 

within the created container object. within the created container object. 

14. The method of claim 8 wherein step (b) includes the 65 25. The method of claim 15 wherein step (1) includes the 
step of receiving a command to display, for an identified step of receiving a command to display, for an identified 
filesystem object, a menu showing a list of substantive filesystem object, a menu showing a list of substantive 
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commands that are applicable to the identified filesystem 
object, and wherein step (2) includes the step of displaying 
a menu showing a list of substantive commands that are 
applicable to the identified filesystem object. 

26. A computer-readable medium whose contents cause a 
computer system having an operating system and a filesys- 
tem hierarchy to perform filesystem hierarchy manipulation 
and filesystem object name selection services in an appli- 
cation programming interface implemented by the operating 
system, the filesystem hierarchy organizing filesystem 
objects having names that identify the filesystem objects 
within the filesystem hierarchy, by performing the steps of: 

(a) receiving an application programming interface call 
from an application program; and 

(b) in response to the received application programming 
interface call from an application program, under the 
control of the operating system: 

(1) .receiving directly from a. user a command to modify 
the filesystem hierarchy, 

(2) processing the received command to modify the 
filesystem hierarchy, 

(3) receiving directly from a user a command to select 
a filesystem object name occurring within the file- 
system hierarchy, and 

(4) returning the selected filesystem object name to the 
application program. 

27. A computer system that has a filesystem hierarchy 
organizing filesystem objects having names that identify the 
filesystem objects within the hierarchy, the computer system 
performing filesystem hierarchy manipulations and filesys- 
tem object name selection services in an application pro- 
gramming interface, comprising: 

a processor for executing application programming inter- 
face code; and 

a memory containing code for a single application pro- 
gramming interface that performs filesystem hierarchy 
manipulation and filesystem object name selection ser- 
vices that is executed on the processor in response to 
receiving an application program interface call from an 
application program, to: 

receive a command to modify the filesystem hierarchy, 
process the received command to modify the filesystem 
hierarchy, 

receive a command to select a filesystem object name 
occurring with the filesystem hierarchy, and 

return the selected filesystem object name to the appli- 
cation program. 

28. A method in a computer system having a filesystem 
hierarchy for sharing a single programmatic interface for 
displaying and manipulating the filesystem hierarchy 
between a file manager program and an application program, 
the method comprising the steps of: 

(a) executing the file manager program enabling a user to 
manage filesystem objects occurring in the filesystem 
hierarchy; 

(b) under the control of the file manager program, directly 
calling the interface; 

(c) in response to step (b), under the control of the 
interface, executing code for displaying the filesystem 
hierarchy and enabling a user to manipulate the file- 
system hierarchy; 

(d) executing the application program; 

(e) under the control of the application program, execut- 
ing code for the application program that is not also 
code of the file manager program for providing a visual 
user interface for opening and saving documents to 
display a visual user interface for opening and saving 
documents; 
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(f) under the control of the code executed by the appli- 
cation program for providing a visual user interface for 
opening and saving documents, directly calling the 
interface; and 

(g) in response to (f), under the control of the interface, 
executing code for displaying the filesystem hierarchy 
and enabling the user to manipulate the filesystem 
hierarchy. 

29. The method of claim 28 wherein step (g) includes the 
step of calling back to the code executed by the application 
program for providing a visual user interface for opening 
and saving documents to add to the visual user interface 
visual a control for manipulating the filesystem hierarchy, 
and wherein the visual interface displayed in step (e) incor- 
porates the added visual control. 

30. The method of claim 29 wherein the added visual 
control is a menu. 

31. The method of claim 29 wherein the added-visual - 
control is a tool bar button. 

32. A computer-readable medium whose contents cause a 
computer system to share a single programmatic interface 
for displaying and manipulating a filesystem hierarchy 
between a file manager program and an application program 
by performing the steps of: 

executing the file manager program enabling a user to 
manage filesystem objects occurring in the filesystem 
hierarchy, wherein the file manager program directly 
calls the interface and wherein the interface enables a 
user to manipulate the filesystem hierarchy; and 

executing the application program, wherein the applica- 
tion program provides a visual user interface for open- 
ing and saving documents and directly calls the 
interface, and wherein the interface enables the user to 
manipulate the filesystem hierarchy. 

33. The computer-readable medium of claim 32 wherein 
the contents of the computer-readable medium further cause 
the computer system to perform the step of, under the 
control of the interface, calling back to the application 
program to add to the visual user interface a visual control 
for manipulating the filesystem hierarchy, and wherein the 
visual interface provided by the application program incor- 
porates the added visual control. 

34. A computer system that shares a single programmatic 
interface for displaying and manipulating a filesystem hier- 
archy between a file manager program and an application 
program, comprising: 

a processor for executing programs; and 

a memory containing: \ 

a file manager program executed by the processor to 
enable a user to manage filesystem objects occurring 
in the filesystem hierarchy, wherein the file manager 
program directly calls the interface and wherein the 
interface enables a user to manipulate the filesystem 
hierarchy, and 
the application program executed by the processor to 
provide an application program functionality, 
wherein the application program provides a visual 
user interface for opening and saving documents and 
directly calls the interface, and wherein the interface 
enables the user to manipulate the filesystem hierar- 
chy. 

35. A method in a computer system having a filesystem 
hierarchy for displaying and enabling a user to modify the 
filesystem hierarchy under the control of a single program- 
matic interface on behalf of both a first application program 
and a second application program, the method comprising 
the steps of: 
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(a) executing the first application program; 

(b) on behalf of the first application program, directly 
calling the interface; 

(c) in response to step (b), under the control of the 
interface, executing code for displaying the filesystem 
hierarchy and enabling the user to manipulate the 
filesystem hierarchy; 

(d) executing the second application program; 

(e) on behalf of the second application program, directly 
calling the interface; and 

(f) in response to step (e), under the control of the 
interface, executing code for displaying the filesystem 
hierarchy and enabling the user to manipulate the 
filesystem hierarchy. 

36. A computer-readable medium whose contents cause a 
computer system having a filesystem hierarchy to display 
and enable a user to modify the' filesystem' hierarchy under 
the control of a single programmatic interface on behalf of 
both a first application program and a second application 20 
program by performing the steps of: 

(a) executing the first application program; 

(b) on behalf of the first application program, directly 
calling the interface; 

(c) in response to step (b), under the control of the 
interface, executing code for displaying the filesystem 
hierarchy and enabling the user to manipulate the 
filesystem hierarchy, 

(d) executing the second application program; 

(e) on behalf of the second application program, directly 
calling the interface; and 

(f) in response to step (e), under the control of the 
interface, executing code for displaying the filesystem 
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hierarchy and enabling the user to manipulate the 

filesystem hierarchy. 
37. A method in a computer system having a filesystem 
hierarchy for sharing a single programmatic interface for 
displaying and manipulating the filesystem hierarchy 
between a file manager program and an application program, 
the method comprising the steps of: 

(a) executing the file manager program enabling a user to 
manage filesystem objects occurring in the filesystem 
hierarchy; 

(b) under the control of the file manager program, direcdy 
calling the interface; 

(c) in response to step (b), under the control of the 
interface, executing code for enabling a user to manipu- 
late the filesystem hierarchy; 

(d) executing the application program; 

(e) under the control of the application program, execut- 
ing code for the application program that is not also 
code of the file manager program for providing a user 
interface for opening and saving documents; 

(f) under the control of the code executed by the appli- 
cation program for providing the user interface for 
opening and saving documents, directly calling the 
interface; and 

(g) in response to (f), under the control of the interface, 
executing code for displaying the filesystem hierarchy 
and enabling the user to manipulate the filesystem 
hierarchy. 
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